docs: Improve the gtk4-launch man page

Be more precise about where desktop files are found.

Fixes: #4081

diff --git a/docs/reference/gtk/gtk4-launch.xml b/docs/reference/gtk/gtk4-launch.xml
index aeb5e8dca14da7a668e28567e8cc14513c1ec562..8ee32141a00f1da1114e7612eba53ef27939c9fa 100644 (file)
--- a/docs/reference/gtk/gtk4-launch.xml
+++ b/docs/reference/gtk/gtk4-launch.xml
@@ -46,7 +46,8 @@ display, unless specified otherwise.
 <para>
 <command>gtk4-launch</command> takes at least one argument, the name of
 the application to launch. The name should match application desktop file name,
-as residing in /usr/share/application, with or without the '.desktop' suffix.
+as residing in the applications subdirectories of the XDG data directories, with
+or without the '.desktop' suffix.
 </para>
 <para>
 If called with more than one argument, the rest of them besides the application
@@ -71,4 +72,14 @@ application.
   </variablelist>
 </refsect1>
 
+<refsect1><title>Environment</title>
+  <para>Some environment variables affect the behavior of <command>gtk4-launch</command>.</para>
+  <variablelist>
+    <varlistentry>
+    <term><option>XDG_DATA_HOME</option>, <option>XDG_DATA_DIRS</option></term>
+      <listitem><para>The environment variables specifying the XDG dta directories.</para></listitem>
+    </varlistentry>
+  </variablelist>
+</refsect1>
+
 </refentry>